Reference for Wiring version 0027+. If you have a previous version, use the reference included with your software. If you see any errors or have any comments, let us know.

Class

String

Name

equalsIgnoreCase()

Examples
void setup() { 
  Serial.begin(9600); 
  String str1 = String("CCCP");
  String str2 = String("ccCP");
  // Tests to see if str1 is equal to str2
  if(str1.equalsIgnoreCase(str2) == true) {
    // They are equal ignoring case differences so this line will print
    Serial.println("Equal");  
  } 
  else {
    Serial.println("Not equal");
  }
} 

void loop() { 
  // Nothing for loop()
}

String str1 = String("CCCP");   
String str3 = String("cccp"); 
// Tests to see if str1 is equal to str3   

void setup() { 
  Serial.begin(9600); 
  if(str1.equalsIgnoreCase(str3) == true) {   
    // They are equal ignoring case differences so this line will print
    Serial.println("Equal");  
  }  
  else {   
    Serial.println("Not equal");
  }
} 

void loop() { 
  // Nothing for loop()
}
Description Compares two strings to see if they are equal ignoriong case differences. This method is necessary because it's not possible to compare strings using the equality operator (==). Returns true if the strings are the same and false if they are not.
Syntax
equalsIgnoreCase(str)
Parameters
str String: any valid String
Returns boolean
Usage Application
Updated on September 16, 2010 11:34:12pm PDT

Creative Commons License